home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 20
/
Cream of the Crop 20 (Terry Blount) (1996).iso
/
bbs
/
msrch11.zip
/
DSZ.DOC
< prev
next >
Wrap
Text File
|
1996-07-07
|
6KB
|
130 lines
Documentation for MultiSearch Text Door
Setting Up a DSZ Configuration File
Written by Robert V. Chambers
Copyright (c) 1996
If you are running a one or two node board with standard comm ports you might
not need to do any configuration in order to successfully run DSZ, GSZ, or
FDSZ. The door is set up to run a default parameter set that should work in
most cases. The default command line for DSZ or GSZ is:
port <port num> handshake on sb <path to file>
| | | | |___ path to selected file
| | | |___________ use YModem (or other protocol)
| | |_____________________ handshake on
| |_______________________________ port number (from drop file)
|________________________________________ port command
FDSZ accepts a smaller list of commands. The default command line for FDSZ is:
<port num> sb <path to file>
| | |___________________ path to selected file
| |____________________________ use YModem (or other protocol)
|____________________________________ port number (from drop file)
Note that the actual program name (ex: dsz) is supplied by the door along with
these default command lines. Remember you selected the program type using
option 3 in MULTEDIT.EXE.
If you are using non-standard port settings or if you need to add additional
parameters the defaults may not work for you.
If this is the case then you will have to create DSZ.CFG using any Dos text
editor. This file will let you fully specify most command line options you
need to successfully run DSZ, GSZ, or FDSZ. Create this file in the same
directory as the other door files. If the door does not detect that the file
exists it will use the default settings described above. Otherwise it will
read DSZ.CFG for your specified parameters. As such you MUST specify
parameters for every comm port your system uses. DSZ.CFG will be read prior to
each download.
The door will assume that if DSZ.CFG exists, then YOU are taking control and
that you will specify each and every comm port independently. It is essential
that you fully describe each comm port you will be using. The door will detect
the port that the user is using and will use either the default settings or
your settings, depending on whether or not DSZ.CFG exists.
Note that you cannot specify send commands (ex: sz) or pathnames that are part
of the complete DSZ command line. This is taken care of internally by the door
depending on the selected protocol. DSZ.CFG is used only to specify port
information for each comm port. Likewise you cannot specify any commands that
might follow the send command.
The format for DSZ.CFG is:
comm port number
comm port parameters
You must have a two-line pair like this for each comm port you will be using.
If you are specifying non-standard comm port addresses you MUST use the
"portx" DSZ command for DSZ or GSZ. If you are unsure about this please read
your DSZ documentation. Here is an example of how to assign port 2 to address
2f8, interrupt 3:
2 <-------------------------- port 2 (door will detect user's port)
portx 2f8,3 ha on <---------- base address 2f8,IRQ 3 handshake on
(FDSZ does not support portx. You typically do not need a config file if
running FDSZ.)
For standard comm ports you could specify:
1 <--------------------------- port 1 (door will detect user's port)
port 1 handshake both <------- port 1, handshake both
Again, you will note that you do NOT specify the program name, the protocol,
or the path to the file. The door will do this.
-----------------------------------------------------------------------------
NOTE
Only COM1 and COM2 are standard on all PC compatible computers.
COM1 uses 3F8 and IRQ4. COM2 used 2F8 and IRQ3.
Multiple standards exist for COM3 and above.
-----------------------------------------------------------------------------
DSZ COM3 uses 3E8 and IRQ4. DSZ COM4 uses 2E8 and IRQ3.
DSZ COM7 uses 3E8 and IRQ5. DSZ COM8 uses 2E8 and IRQ5.
If you wish to use COM3 or COM4 and your computer is not set up as shown
above, you MUST use the "portx" command to specify the actual base address and
interrupt vector.
Note that COM1 and COM3 use the same IRQ. You should not have two hardware
devices that use these ports at the same time or problems will almost
certainly arise, even if both devices are not active. The same applies to the
COM2-COM4 pair. Please read the following excerpt from the DSZ documentation.
This is from the DSZ documentation file:
" ***********************************************************
Except as noted, all commands and options must be typed in lower case.
DO NOT USE UPPER CASE!!
Case is significant!
***********************************************************
Optional commands or arguments are shown in square brackets [].
When used (in any combination), the A, CON, port, speed, handshake,
estimate, and d commands must be used in exactly this order.
dsz [A] [CON] [F] [port N] [speed S] [handshake XX] [pxN... ] [z
pxN... ] [D] [d] [restrict] [G] command
Incorrectly configured serial ports that work with programs that pig
out both IRQ3 and IRQ4 will lock up with DSZ. If DSZ locks up the
machine as soon as it tries to send or receive data, this is usually
the fault. Make sure the comm port is strapped correctly; COM1 uses
IRQ4, COM2 uses IRQ3. DSZ will lock up if the comm port is not
properly set up.
In addition, DSZ will not work properly if two devices are connected
to the same IRQ line, even when some other programs (that don't use
interrupts as intensively) do work normally on the same machine. Make
sure no other device uses the same IRQ as DSZ even if that device is
not active.
COM3 and above are not widely standardized. If you have problems with
COM3 or COM4, chances are your "COM3" is non standard."